home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 21 / AACD 21.iso / AACD / Utilities / Help / locale / help / english / sys / resident.doc < prev    next >
Encoding:
Text File  |  2000-10-06  |  3.5 KB  |  102 lines
  1. RESIDENT
  2.  
  3. Displays and modifies the list of resident commands.
  4.  
  5. Format
  6.  
  7. RESIDENT [<resident name>] [<filename>] [REMOVE] [ADD] [REPLACE] [PURE |
  8. FORCE] [SYSTEM]
  9.  
  10. Template
  11.  
  12. NAME,FILE,REMOVE/S,ADD/S,REPLACE/S,PURE=FORCE/S,SYSTEM/S
  13.  
  14. Location
  15.  
  16. Internal
  17.  
  18. RESIDENT loads a command into memory and adds it to the resident list
  19. maintained by the Shell. This allows the command to be executed without
  20. reloading it from disk each time. If RESIDENT is invoked with no options, it
  21. lists the programs on the resident list.
  22.  
  23. To be made resident, a command should be pure, meaning that it is both
  24. re-entrant and re-executable. A re-entrant command can properly support
  25. independent use by two or more programs at the same time. A re-executable
  26. command dies not have to be reloaded to be executed again. Commands that have
  27. these characteristics are called pure and have the p (pure) protection bit
  28. set.
  29.  
  30. The following commands cannot be made resident: BINDDRIVERS, CONCLIP, IPREFS,
  31. LOADRESOURCE, LOADWB, and SETPATCH.
  32.  
  33. LIST the C: directory to check for the presence of the p protection bit to
  34. determine which commands are pure.
  35.  
  36. Many of the commands in the C: directory, as well as the MORE command in
  37. Utilities, are pure commands and can be made resident. If a command does not
  38. have its pure bit set, it probably cannot be made resident safely. (Setting
  39. the pure bit does not make a command or program pure.)
  40.  
  41. The REPLACE option is the default option and does not need to be explicitly
  42. stated. If no <resident name> is specified (for example, only a file name is
  43. specified), RESIDENT uses the file name portion as the name on the resident
  44. list. The full path to the file must be used.
  45.  
  46. If a <resident name> is specified and RESIDENT finds a program with that name
  47. already on the list, it attempts to replace the command. That <resident name>
  48. must be used to reference the resident version of the command. The
  49. replacement succeeds only if the already-resident command is not in use.
  50.  
  51. To override REPLACEment and make several versions of a command resident
  52. simultaneously, use the ADD option, giving a different <resident name> for
  53. each version loaded.
  54.  
  55. If the System option is specified, the command is added to the system portion
  56. of the resident list and becomes available as a system component. Any
  57. commands added to the resident list with the SYSTEM option cannot be removed.
  58. To list these files on the RESIDENT list, you must specify the SYSTEM option.
  59.  
  60. The PURE option forces RESIDENT to load commands that are not marked as pure
  61. and use them to test the pureness of other commands and programs. Use the
  62. PURE option with caution. Be sure the programs that you make RESIDENT meet
  63. the criteria to be resident or be careful to use the command in only one
  64. process at a time.
  65.  
  66. The availability of internal commands can also be controlled with RESIDENT.
  67. To deactivate an Internal command (for example, if an application has its own
  68. command of the same name), use RESIDENT <command> REMOVE. The command can be
  69. reactivated with the REPLACE option.
  70.  
  71. Example 1:
  72.  
  73. 1> RESIDENT C:COPY
  74.  
  75. makes the COPY command resident (replaces any previous version).
  76.  
  77. Example 2:
  78.  
  79. 1> RESIDENT Copy2 DF1:C/COPY ADD
  80.  
  81. adds another version of COPY to the resident list, under the name Copy2.
  82.  
  83. Example 3:
  84.  
  85. 1> RESIDENT Xdir DF1:C/Xdir PURE
  86.  
  87. makes an experimental, non-pure version of the DIR command resident.
  88.  
  89. Example 4:
  90.  
  91. 1> RESIDENT CD REMOVE
  92.  
  93. makes the Internal CD command unavailable.
  94.  
  95. Example 5:
  96.  
  97. 1> RESIDENT CD REPLACE
  98.  
  99. restores the CD command to the system.
  100.  
  101. See also: PROTECT, LIST.
  102.